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CHAPTER | - RELEASE NOTICE 


1. CHAPTER I - RELEASE NOTICE 


1.1 PREFACE + 4. eee e 
This document is the release notice for Versian,.3.0. of TIP/30 
(Transaction Interface Processor), a software produtt’ Geveloped by 
Allinson-Ross Corporation. i) ahuaae 
The names TIP and TIP/30 are used interchangeably in this 
document. a 


ese a ae 
Please direct any inquiries or requests for further information 


tos 
Allinson-Ross Corporation 
4291 Village Centre Court 
Mississauga, Ontario 
Canada L42 182 
Tel. (416) 848-2030 
TWX. (610) 492-5390 
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INTRODUCTION 


L.3 INTRODUCTION 


TIP/30 Release 3.0 is a major new release of the TIP/30 software 
product. This release contains a number of new facilities and 
significant changes to many of the internals of TIP/30. 


Version 3.0 of TIP/30 provides support for System/80, and Series 
90 machines running OS/3 6.0 thru 8.2. Errors reported in previous 
releases have been corrected. 


This release of TIP/30 DOES NOT support releases of OS/3 prior 
to release 6. This release of TIP/30 has grown in size by 
approximately 24K bytes of memory. To keep the same paging area as 
before, you should add hex 6000 to your TIP/30 job card. 


The TIP/30 system must be re-generated with the new software to 
take advantage of the corrections and enhancements included in this 
release. Refer to the section on installation procedures for 
details. 


A completely new version of the TIP/30 Reference Manual ARP-600 
is available with release 3.0 of fTIP/30. Each site will 
automatically receive two (2) complete sets of this documentation. 
Any additional copies can be ordered at a cost of $65.00 for the 
documentation only or $100.00 for complete binder sets. 





Page: TIP/30 Release Notice 
Section: Version 3.0 (84/08/01) 














INTRODUCTION 


«a 


1.4 OBSOLETE TIP/30 SUBROUTINE CALLS 


The following TIP/30 subroutines are no longer available (as of 
release 3.0 of TIP/30). 


Each of the subroutines has been replaced by the subroutine call 
indicated below. 


OLD SUBROUTINE SIMILAR SUBROUTINE 
TIPCALL TIPSUB 
TIPGOTO TIPXCTL 
TIPBACK TIPFORK 
TIPRET TIPRTN 
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ON-LINE DATA DISPLAY (ODD) 


ON-LINE DATA DISPLAY (ODD) 


The Online Data Display program (ODD) is no _ longer being 
Supported and the documentation has been removed from the Reference 
Manual. This program has been superceded by the TIP/30 Query 
Language (TQL). ODD has been included on the release tape as a 
courtesy to people still converting. 


1.6 MESSAGE CONTROL SYSTEM 


[1] The message control system has been substantially 
REWORKED. Message formats may now be placed in user 
specified groups. Default data may now be specified for 
data fields. Special heading fields to automatically 
include the date, time, userid etc are now available. 
Special emphasis underline is used for the UTS-30 and 
UTS-40 terminal types. Colour data fields and headings 
are supported for the UTS-60 terminal. 


IBM-3270 terminals will be supported for MCS screen I/O 
only. Note that 3270 support is not available for the 
initial release of 3.0. If you need 3270 support for MCS 
please call Allinson-Ross for a pre-release. It should be 


available shortly as standard issue. 


New message definition and update programs are provided 
in 3.0. The new programs allow partial screen updates and 
retention of information on the "Option" screen. 
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PROGRAM CONTROL SYSTEM 


PROGRAM CONTROL SYSTEM 


[1] 


A new PIB for TIP/30 programs is supported. This has much 
new information and many new facilities. The new PIB 
contains new fields such as date, time, security code, 
group access, last MCS name and LOCAP name. Please read 
the TIP/30 Reference Manual PCS section. 


A new version of TIPPRINT now supports MS-DOS file 
transfer (the file name may be ?:xxxxxx to indicate file 
transfer). TIPPRINT now picks up system defined defaults 
for TOP-OF-FORM, PAGE-LENGTH, etc. from TIP generation 
Statements. 


Distributed Transaction Processing is now supported. This 
allows transactions to be routed to other TIP/30 systems 
running in other machines. Please refer to the Reference 
Manual for details. 
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DATA BASES 


1.8 DATA BASES 


[1] 


A multi-thread interface to DMS/90 from TIP/30 and IMS/90 
programs is now available. To generate TIP/30 with the 
multi-thread DMS interface, specify DBMS=DMT,n where n 
represents the number of threads to allow. 


TIP/30 may now be generated to interface to more than one 
data base. The second and third interfaces are specified 
by using the new generation keywords DBMS2= and DBMS3=. 
The parameters for these new keywords are simply whatever 
would be specified for the DBMS= parameter. 


1.9 IMS/90 EMULATOR 


[1] 


[2] 


Page: 
_ Section: 





Numerous corrections applied at various customer sites 
have been incorporated into the standard emulator. 


Several TIP/30 generation parameters have been added in 
an attempt to customize the emulation of IMS/90 and its 
peculiarities. Please reference the parameter IMS= in the 


TIPGEN section of the Reference Manual. You may need to 
specify some new option. 


The IMS emulator now supports MIRAM in the same manner as 
IMS/90: refer especially to the discussion of the SETK 
call in the IMS documentation, 
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DYNAMIC LIBRARY SUPPORT 


1.10 DYNAMIC LIBRARY SUPPORT 


[1] It is no longer necessary to generate libraries into the 
TCA. As of release 3.0, you are allowed dynamic access to 
libraries via the TIP/30 catalogue. If you use the 0S/3 
SYSCAT, it won't even be necessary to put dynamic 
libraries in TIP/30's execution jcl. 


[2] WARNING:Do not generate libraries into our TCA 


keywords CLOSE=NO or AFTER=YES. These are no longer 
and may prevent TIP/30's execution. 


1.11 TIP/30 UTILITY PROGRAMS 
The following is a summary of what has changed since release 


2.5R1. To get the details you must read the appropriate sections of 
the TIP/30 Reference Manual. 


ACCESS no change 


AFT now indicates whether user is attached to DMS/90 


ALLOC new program for allocating OS/3 files 
APB no change 
APT new appointment scheduler system 
ASG no change 


BANNER new program to display/update the TIP/30 ready 
message text 


BASIC interface to TIPPRINT, double precision support, 
calculation tolerence, defined functions, see 
ARP-600 for further details 
BCP no change 


CALENDAR now blinks current day and supports Julian format 
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cc 

CCA 
CONNECT 
CPAGE 
CRASH 
CREATE 
DBD, DBDU 
DCF 

DD, DDU 
DEBUG 
DEFKEY 
DIE 
DISABLE 
DLL 


boc 


DOF 
DOWN 
ENABLE 
EOJ 
FCLOSE 


FIN 
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TIP/30 UTILITY PROGRAMS 


many new parameters, see ARP-600 

command line driven and tabulates "TO" clauses 
new print command, locap display 

new program to connect a distributed TIP/30 host 
no change 

no change 

no change 

data base (DMS/90) version of DD. 

new program to display OS/3 SYSCAT info 

now processes alternate MIRAM indexes 

no change 

now screen format driven 

no change 

new program to disable terminals 

supports UTS-30 and UTS-40 terminals 

can now include partial screen formats 


@M command format changed! 


displays LBL name (if FILELOCK=SHARE) 


no change 

new program to enable terminals 
may now change timeout value 

no change 


no change 
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TIP/30 UTILITY PROGRAMS 


* 


@ FOPEN no change 


FREE no change 
FSE new screen driven text editor, see ARP-600 
HANGUP no change 
HELP now screen format driven, tree structured 
IDA displays more than 16 bytes via a length operand 
JBQ low queue display replaces the list command 
JCL option to run job and scratch edit buffer 
LOGOFF no change 
LOGON now displays appropriate error messages, 
5 minute penalty after 4 password guesses 
Ability to change password at logon time removed 
MAIL completely new MAIL system, see ARP-600 
@ MAILLIST new mail distribution list facility 
MEM no change 
MENU new menu system, see ARP-600 
MODE no change 
MSG no change 
MSGAR some new commands, see ARP-600 
MSGDEF completely re-written, see ARP-600 (TFD & TFU) 


MSGSHOW defaults filler character to '_', allows testing 
of screens in other groups 


NET minor change for F2 direct to CCA 


NEWPASS new program for changing logon password 
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NEWUSER 
NOTE 
OCN 


OPEN 


PMDA 
QED 
RELOAD 


REMOVE 


RPG 
RV 


SCR 


SCRATCH 


SET 
SORT 


SPL 


STATUS 
STOP 
SUBMIT 
SWTCH 
SYM 


SYS 
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no change 
no change 
new program to display system activity 


many new commands, EXPORT see 


section on TOL 


SELECT, SORT, 


prints single spaced 

no change 

issues warning if program is RESIDENT 

a distributed TIP/30 


new program to disconnect 


host 

no change 

no change 

new program to scratch OS/3 files 

no change 

many new options, see ARP-600 

new program for sorting edit buffers 
new LE command, see ARP-600 
to MS-DOS files (feature of 


may now spool 


TIPPRINT) 

now displays DMS/90 statistics 

no change 

new program for submitting JCL containing QGBLs 
no change 

no change 


displays largest free memory and RV's job name 
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TIP/30 UTILITY PROGRAMS 


TBSINT this was the batch program to format various 
TIP/30 files. This no longer exists! It has been 
replaced by a new program call TBSFMT. 

TCB no change 
TFD, TFU new version of MSGDEF 
TIPFLG no change 


TLIB may now copy to/from MS-DOS files, also, may now 
delete load/object modules from libraries 


UP no change 
new program to list uSer-ids and comments 
new print command, improved listing showing 
percentage of file used, shows cylinder and track 
allocation. 


now shows the LOCAP (if using DTP). 


screen format is used. 
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RELEASE 3.0 COMPATIBILITY with 2.5 and 2.5R1 


RELEASE 3.0 COMPATIBILITY with 2.5 and 2.5R1l 


Due to the number of corrections and enhancements in 3.0, the 
internal data structures of TIP/30 have changed quite a bit. Some 
Subroutines called by user programs are linked directly with the 
user program. These subroutines will no longer work correctly on 
release 3.0. You must re-compile and re-link any of your native 
TIP/30 programs which use these special routines: 


TIPPRINT 
TI PMSGRV 
TIPMSGCL 
TIPTG 
TIPUSR 
TIPATTCH 
TIPUALT 
TIPUORG 


If you neglect to re-compile and re-link the programs which use 
these routines (after installing 3.0) you. may get very 
unpredictable results. Check your LNKEDT map to see if a problem 
you are experiencing may be related to these subroutine calls. 


-1 QUICK ROLLBACK 


In release 2.5 and 25R1, you had to run TBSRCV with a parameter 
of QUICK, to roll back any un-completed transactions. before 
bringing the online system back up. TIP/30 now does this as part of 
its normal startup procedures. In fact the only way to prevent it 
from happening would be to re-format the TIPSB4 file before 
bringing the system up. This could be done as follows: 


RV TJSJRINT, ,F=TIPSB4 
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1.13 INSTALLATION PROCEDURES 


KKK KKK EEK KKK KKK KK EKER ERRERREREREKKEREREKEEEKR 
KK Kk KK RK KR KK KK KK KK KKH KK KE KEK RK KK KR KK KK KE KR KK 
** 
* 


STEP 0: Backup your current TIP/30 system and all ** 


associated files (TIPSCAT,TIPSRNDM,TIPLOD,TIP); * 
** 


* 


BE PREPARED to restore them if need be. ae 
* 


Better safe than SORRY !! ne 

* 

kk ** 
KK Kk Kk KR KK Re KR KR KR RK KR KR RK KR KR KR K RK RK KE KH KH KEK KEK RK KR KR KE 
KREEKKKEEKKEREREEREKREERREEKKKERKKEKKERERKKEEKEKREREKRREEKEKRKKEREE 
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(3] 


[4] 


[5] 


Page: 


Section: 





INSTALLATION PROCEDURES 


Do not load 3.0 tape just yet! Several 2.5 jobs must be 
run using the older 2.5 load modules. For our purposes, 
2.5 and 25R1l are considered the same level of software. 


To your existing jcl for TIP/30, add a reference for a 


file which we will create later called TIPSMCS. This 
should look like this: 


//  &$LBL TIPSMCS 


If you don't have one, create the file TIPSCATB with the 
2.5 job TJSCATB. This should be in SYSJCS or the TIP 
library. You should enter: 


RV TJSCATB, ,DVC=??,VOL=vsn,EXT=nn,SCR=YES 


?? the device number of the disc 
vsn the volume serial number of the disc 
nn the size in cylinders of the real TIPSCAT 


SCR=YES causes the scratch of an existing TIPSCATB 


Now you must copy the current TIPSCAT into TIPSCATB. This 
can be accomplished by running the 2.5 job TJSCRBAK. No 
parameters are required since we are only interested in 
the disc file. 


Now you may load the release tape to the TIP library. If 
you use the 2.5 job TJSLOAD remember to change the tape 
LBL cards to match the release 3.0 job which follows. 
Otherwise, key in and run this job: 
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INSTALLATION PROCEDURES 


TJISLOAD,H,C000 

ACCT=TIP,VT 

ACN=&ACCT 

('&VvT' NE '')VTORK 

'VT PARAMETER MISSING, RERUN.' 
"SPECIFY VT=(DVC-NO,VOL-NAME)' 
TEST 

END 

"LOADING TIP/30 DISTRIBUTION TAPE' 
‘PL Ps: VT=EVT’ 

90 

TIPS$30 

TIP30SVERS0300 

TAPE 

&VT(1) 

&VT(2) 

SLOK30.TIPSLIB 

ERR340K 

ERR340K 

&VT(1) 

&VT(2) 

SLOK30.TIPSLIB 

ST,CF,5,BLK, (256,16000) 

TIP 

20 

PRNTR 

LIBS, ,6 


D1=TIP,T1=TAPE 
Tl,L,TBSBAK,D1l 


TAPE, RL 

90 

TIP$30 
TIP30SVERS$0300 
TAPE 

TAPE ,FM, 3 
TBSBAK,TIP,6 
LIBS, ,6 


D1=TIP,D2=$YS$JCS 
D1, ,TI$,D2 
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INSTALLATION PROCEDURES 


If TIP/30 was distributed on diskettes, the following job may be 
used to load the diskettes: 


JOB 
GBL 
OPTION 
IF 
JNOTE 
JNOTE 
OPTION 
GO 
OPR 
OPR 
OPR 
DVC 
VOL 
IF 
VOL 
IF 
VOL 
iF 
VOL 
ie 
VOL 
LBL 
LFD 
DVC 
VOL 
LBL 
LFD 
SCR 
DVC 
VoL 
LBL 
E&T 
LFD 
DVC 
LFD 
EXEC 


FIL 
COP 


EXEC 


FIL 
COP.C 


TIJSLOADD,H,C000 
ACCT=TIP,VT,V=(TIPS$30,TIPS31,TIPS$32,TIPS$33,TIPS34) 
ACN=&ACCT 

('&VT' NE '')VTOK 

‘VT PARAMETER MISSING, RERUN.' 
"SPECIFY VT=(DVC-NO,VOL-NAME) ' 
TEST 

END 

"LOADING TIP/30 DISTRIBUTION DISKETTES’ 
"TIP: VT=&VT' 

"DISKETTES: V=&V' 

130 

&V(1) 

CEvi2)? ' )NOV2 

&V(2) 

('&v(3)' ')NOV3 

&V(3) 

('&v(4)' ')NOV4 

&V(4) 

('s&v(5)' ')NOV5 

&V(5) 

DATA 

*DISKET 

&VT(1) 

&VT(2) 

S$LOK30.TIPSLIB 

ERR340K 

ERR340K 

&VT(1) 

&VT(2) 

$LOK30.TIPSLIB 

ST,CF,5,BLK, (256,16000) 

TIP 

20 

PRNTR 

LIBS, ,6 


D1=TIP,T1=DISKET 
TL p97 Dt 


LIBS, ,6 


D1=TIP,D2=SYSJCS 
D1, ,TJ$,D2 
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INSTALLATION PROCEDURES 


NOP 


At this point, the 2.5 system will no longer be operative 
and all the "TJS" prefixed jobs will have been replaced 
with 3.0 versions. Many differences exist. If you aren't 
using our jcl format you'll have to go through your jel 
and review it. 


Now you must copy all the latest TIP/30 load modules into 
the TIPLOD library. Simply enter to following: 


RV TJSCOP 


While TJSCOP runs, you can create a new file for release 
3.0 called TIPSMCS. We no longer store the MCS screens in 
the 2nd partition of TIPSCAT. To create this file, a new 
job TJSMCS exists. To run it: 


RV TJSMCS, ,D=(??,vsn,nn) 


?? the device number of the disc for TIPSMCS 

vsn the volume serial number of the disc 

nn a numeric value which is 3 times the number of 
MCS screens you are uSing. The largest useful 
value is 4096. 
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INSTALLATION PROCEDURES 





[9] If you are using the TIP/30 highspeed block loader file 
(called TIPSBLK), it will be necessary to re-block the 
latest TIP load modules into it. To do this, run the 
following: 


RV TJSREBLK 


[10] Since the 2.5 TIPSCAT will be used in 3.0 only for 
catalogue records it may be too large. You can scratch 
and reformat it with the job TUJSCAT which runs as 
follows: 


RV TUSCAT, ,D=(??,vsn,nn),SCR=YES 


2? the device number of the disc 
vsn the volume serial number of the disc 
nn a numeric value which is 3 times the number of 


CAT records you are using. The largest useful 
value is 4096. 





(11] Now you convert your CAT and MCS records (TIPSCATB), from 
2.5 to 3.0 format. This is done by running the following: 


RV TJ$2T3,, 


D=(2?, vsn) 





?? the device number of the disc for TIPSCATB 
vsn the volume serial number of the disc for 
TIPSCATB 
[12] Wait for the TJSCOP job to complete, then re-generate the 


TIP/30 system (RV TUJSPARAM, ,TCA=yurtca). 
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INSTALLATION PROCEDURES 


You can bring up your TIP/30 system now. You should 
remove or avoid the quick rollback step (RCV=NO) in the 
TIP/30 jcl. This is only a concern if you have the TIPSB4 
file. 


Since the LOGON screen doesn't exist at this time, you 
MUST use the immediate "LOGON User-id/pwd" method to get 
Started. The first step will be to restore screen formats 
required by Allinson-Ross supplied programs. Enter the 
following: 


<TIP/TCSRSTR 
in response to the "TIP?>" prompt. 


The next two steps result in upgrading the TIP/30 
catalogue to release level 3.0. You must decide which is 
the best method to use based on whether you have modified 
Allinson-Ross transaction sizes, securities or group 


An element named TCSCATUP may be used to update catalogue 
records for Allinson-Ross supplied programs. This adds 
new transactions to TIPSCAT but also searches out old 
entries by load module name in any group, updates the 
critical keywords but omits the security level changes. 
If you didn't do anything tricky and have a vanilla 
flavoured TIP/30 catalogue, skip this step and do the 
next one instead. Otherwise, once you have logged on the 
3.0 system, enter the following: 


<TIP/TCSCATUP 
in response to the "TIP?>" prompt. 
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INSTALLATION PROCEDURES 


IGNORE THIS STEP IF YOU USED TCSCATUP! This applies a 


virgin set of Allinson-Ross entries to the catalogue. To 
do this, once you have logged on the 3.0 system, enter 
the following: 


CAT <TIP/TCSCATLG 
in response to the "TIP?>" prompt. 


Since BASIC and the MAIL system were changed for release 
3.0, it will be necessary to delete all old dynamic files 
associated with them. In the case of basic, you MUST 
re-compile all your basic programs. The following should 
take care of the deletions: 


CAT 

DEL *,*BASS,,D 
DEL *,*MAIL,,D 
E 


If you have placed TIP's TC-???? copy books or TI$???? 
object modules in your own libraries, remember to replace 


them with the 3.0 versions. 


At this point the 3.0 system upgrade is complete. Since 
many things have changed, if something behaves 
differently, please read your TIP/30 Reference Manual 
first ! 
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